Element: 


Incall Service *v 


Attributes: 


title 


Children: 


Service 


Description: 


A container A high level tag that marks the start and end of the XML file. Required. 






Element: 


Service V ■ *»* - 


Attributes. 


name 


Parents: 


Incall Service 


Children: 


DN1S | Service description | Multicall | Percall | Reset 


Description: 


A container The parameters in this container describe a service running on a particular phone line (DNIS). 
Each line running Incall Service must have a service described for that line. Required. 






Element: 


DNIS 


Parents: 


Service 


Description: 


The number the caller dialed to reach the application. Required. 






Element: 


Servicedescription 


Parents: 


Service 


Description: 


Audio. The description of the service. This audio is played to reassure the caller that they have dialed the right 
number. Fits the carrier phrase, "Hello. You have reached <System description^" Required. 






Element: 


Multicall 


Parents: 


Service 


Children: 


Callinfo | Authentication | Content | Choices j Valueentry 


Description: 


A container. The parameters specified in Multicall are to be used as default values for all the calls for the 
service specified in Service. Any tag may be specified in Multicall. Parameters set here act as default values 
for all calls for that service until another Multicall file for that service is specified. Optional. 






Element: 


Percall 


Parents: 


Service 


Children: 


Call 


Description: 


A container. Contains the list of calls to be made, one call per Call tag. Required if no Multicall tag specified. 






Element: 


Call 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call info | Authentication | Content | Choices | Value entry | Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag. 








Element: 


Reset 


Parents: 


Service (Call 


Description: 


Resets/Cancels a particular call (if used as a child for Call) or all potential calls for a particular service (if used 
as a child for Service). Optional. 






Element: 


Call info 


Parents: 


Multicall j Call 


Children: 


Phone number | Response url 


Description: 


A container. Contains information about the call, beyond the dialog. Required in either Multicall or Call or 
both. 
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Element: 


Authentication 


Parents: 


Multicall | Call 


Children: 


Authentication code description | Authenticationcode | Expected caller 


Description: 


A container. Contains tags that specify the information necessary for ensuring that the caller is authorized to 
use the service. Authentication is indicated if there is an authentication code passed in from the customer's 
application. If there is an authentication code, there must also be a description of that code. Optional. 






Element: 


Content 


Parents: 


Multicall | Call 


Description: 


Audio. The content message to be played to the caller. The content may be an audio file (*.wav), a text file 
(*.txt) f or raw text (enclosed in double quotes.) Optional. 






Element: 


Value entry 


Parents: 


Multicall [Call 


Attributes: 


mindtgits | maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, "Please enter..." 
and "You will be asked for..." Either Choices or Value entry, but not both, may be specified. Optional. 






Element: 


Choices 


Parents: 


Multicall | Call 


Children: 


Choice | Transfer 


Description: 


A container. Contains information about the list of choices that will be presented to the caller during the call. 
Optional. 






Element: 


Phone number 


Parents: 


Call info 


Description: 


Phone number from which Expected caller is expected to call. Required. 














Element: 


Expected caller 


Parents: 


Authentication 


Description: 


Audio. The name of the person expected to be calling from a given phone number. Optional. 








Element: 


Response url 


Parents: 


Call info 


Description: 


URL that Incall Service is to use to return status information about the call to the customer application. 
Optional. 






Element: 


Authentication code description 


Parents: 


Authentication 


Description: 


Audio. Description of the authentication code the caller will be asked to enter. Fits the carrier phrase, "Please 
enter <authenttcation_code_description>. " For example, "Please enter your account number." Required for 
each Authentication lag. 






— 


Element: 


Authentication code 


Parents: 


Authentication 


Description. 


The digit string value of the caller's authentication code_description. That is, the Autheniicationcode is the 
value that the caller must enter in order to continue with the call. Required for each Authentication tag. 






Element: 


Choice 


Parents: 


Choices 


Children: 


Choice description j Choice value 


Description: 


A container. Describes the choices that are available to the caller. There is usually more than one Choice tag 
per Choices tag. Optional. 






Element: 


Transfer 


Parents: 


Choices 


Children: 


Transfer description | Transfer number 


Description: 


A container. Describes the transfer option available to the caller. If there is a transfer option, the value that the 
caller presses is "0" in order to transfer. Only one Transfer tag is allowed per Choices tag. Optional. 






Element: 


Choice description 


Parents: 


Choice 


Description: 


Audio. Describes the option the caller may choose. Fits the carrier phrase, "If you would like 
<choice description^ press one." Required for each Choice tag. 






Element: 


Choice value 


Parents: 


Choice 


Description: 


A single digit number that indicates the touch-tone that the caller should press in order to select the associated 
choice. Note that if there is a Transfer tag, "0" cannot be used for a Choice_value. Required for each Choice 
tag. 














Element: 


Transfer description 


Parents: 


Transfer 


Description: 


Audio. Describes the person or thing (e.g., IV R) the caller would be transferred to should they press zero. 
Required for each Transfer tag. 






Element: 


Transfer number 


Parents: 


Transfer 


Description: 


The phone number to which the caller would be transferred, if they press zero. Required for each Transfer tag. 
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Element: 


Outcall service 


Attributes: 


title 


Children: 


Multicall | Percall 


Description: 


A container. A high level tag to mark the start and end of the XML file. Required. , 




Element: 


Service * - 


Attributes: 


name 


Parents: 


Outcall service 


Children: 


Service description | Multicall | Percall | Reset 


Description: 


A container. The parameters in this container describe a service. There can be several services set up for 
Outcall. This tag allows the developer to group Multicall values. Required. 




Element: 


Multicall 


Parents: 


Service 


Children: 


Call_info | Introduction | Authentication | Content | Value_entry | 
Choices 


Description: 


A container. Indicates that the parameters specified are to be used as default values for all the calls. Any tag 
may be specified in multicall. Parameters set here act as default values for all calls until another multicall 
file is specified. Optional. 




Element: 


Percall 


Parents: 


Service 


Children: 


Call 


Description : 


A container. Contains the list of calls to be made, one call per Call tag. Required if no Mult i call tag 
specified. 




Element: 


Reset 


Parents: 


Service | Call 


Description: 


Resets values for parent tag and all its children tags already specified. Useful for canceling queued calls 
before they're made. Optional. 




Element: 


Call 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call_info | Introduction | Authentication | Content | Value_entry | 
Choices | Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag. 




Element: 


Call info 


Parents: 


Multicall | Call 


Children: 


Phonenumber | Response url | Ensure completion 


Description: 


A container. Contains information about the call, beyond the dialog. Required in either Multicall or 
Call or both. 




Element: 


Introduction 


Parents: 


Multicall | Call 


Children: 


Recipient | Sender 


Description: 


A container. Contains the information for the introduction portion of the call, the sender and the desired 
recipient. Required in either Multicall or Call or both. 
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Element: 


Authentication 


Parents: 


Multicall | Call 


Children: 


Authentication code description (Authentication code 


Description: 


A container. Contains tags that specify the information necessary for ensuring that the called party is the . 
intended recipient of the call. Optional. Authentication is indicated if there is an , 
authent ication_code passed in from the customer's application. If there is an v ;* * . 
authent icat ion code, there must also be a description of that code and a recipient. 




Element: 


Content 


Parents: 


Multicall |Call 


Description: 


Audio. The content message to be played to the called party. The content may be an audio file (*.wav), a 
text file (*.txt), or raw text (enclosed in double quotes.) Optional. 




Element: 


Valueentry 


Parents: 


Multicall | Call 


Attributes: 


mindigits | maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, "Please 
enter..." and "You will be asked for...'* Either Choices or Value_entry, but not both, may 
be specified. Optional. 




Element: 


Choices 


Parents: 


Multicall | Call 


Children: 


Choice | Transfer 


Description: 


A container. Contains information about the list of choices that will be presented to the user during the call. 
Either Choices or Value entry, but not both, may be specified. Optional. 




Element: 


Phone number 


Parents: 


Call info 


Description: 


Phone number to be called. Must include every digit that is to be dialed (e.g., 9 to get an outside line, 1 for 
longdistance). Required. 




Element: 


Response url 


Parents: 


Call info 


Etescription: 


URL that Outcall service is to use to return status information about the call to the customer application. 
Optional. 




Element: 


Ensure completion 


Parents: 


Call info 


Description: 


The number of times that Outcall service will call a person back, if the person has authenticated. These 
callbacks increase the likelihood of the completion of a desired call that was dropped accidentally (for 
instance, by the network). Optional. Default is 0. 




Element: 


Recipient 


Parents: 


Introduction 


Description: 


Audio. Usually text to be converted to speech. Fits the carrier phrase, "This is an automated 
call for <Recipient> from <Sender>." If Recipient is omitted from the XML, no authentication is 
done; rather, the called party is asked to press 1 to continue. Optional. 




Element: 


Sender 


Parents: 


Introduction 


Description: 


Audio. Fits the carrier phrase, "This is an automated call f rom <Sender>." Required. 




Element: 


Authentication codede script ion 


Parents: 


Authentication 


Description: 


Audio. Description of the authentication code the called party will be asked to enter. Fits the carrier phrase, 
"Please enter <authentication_code_description>." For example, "Please enter your 
account number/' Required for each Authentication tag. 



f l 6. ' ^"^ 



• • 


Element: 


Authentication code 


Parents: 


Authentication - * " • f 


Description: 


The digit string value of the called party's authent ication_code_de script ion. That is, the 
Authenticat ion code is the value that the called party must enter in order to continue with the call. 
Required for each Authent icat ion tag. ' ■* ■- •" 




Element: 


Choice 


Parents: 


Choices 


Children: 


Choice description | Choice^value 


Description: 


A container. Describes the choices that are available to the called party. There is usually more than one 
Choice tag per Choices tag. Optional. 




Element: 


Transfer 


Parents: 


Choices 


Children: 


Transfer description | Transf ernumber 


Description: 


A container. Describes the transfer option available to the called party. If there is a transfer option, the 
value that the called party presses is "0" in order to transfer. Only one Transfer tag is allowed per 
Choices tag. Optional. 




Element: 


Choice description 


Parents: 


Choice 


Description: 


Audio. Describes the option the called party may choose. Fits the carrier phrase, "I f you would like 
<choice_description>, press one." Required for each Choice tag. 




Element: 


Choice value 


Parents: 


Choice 


Description: 


A single digit number that indicates the touch-tone that the called party should press in order to select the 
associated choice. Note that if there is a Transfer tag, "0" cannot be used for a Choice_value. 
Required for each Choice tag. 




Element: 


Transf erdescript ion 


Parents: 


Transfer 


Description: 


Audio. Describes the person or thing the called party would be transferred to should they press zero. 
Required for each Transfer tag. 




Element: 


Transfer number 


Parents: 


Transfer 


Description: 


The phone number to which the called party would be transferred, if they press zero. Required for each 
Transfer tag. 



